HAL PKA constants migration

This section provides information about the HAL PKA constants migration.

HAL PKA error code constants

HAL1

HAL2

#define HAL_PKA_ERROR_NONE
#define HAL_PKA_ERROR_ADDRERR
#define HAL_PKA_ERROR_RAMERR
#define HAL_PKA_ERROR_OPERATION
/* Missed in HAL1 */

#define HAL_PKA_ERROR_INVALID_CALLBACK

#define HAL_PKA_ERROR_TIMEOUT
#define HAL_PKA_ERROR_NONE
#define HAL_PKA_ERROR_ADDRERR
#define HAL_PKA_ERROR_RAMERR
#define HAL_PKA_ERROR_OPERATION
#define HAL_PKA_ERROR_RESULT

Removed : The APIs will return HAL_INVALID_PARAM when the user provides invalid parameters.

Removed : The API HAL_PKA_Compute() will return HAL_TIMEOUT status when exceeding the user timeout.

Related concept: Revised and optimized HAL error management


HAL PKA flags constants

The listed defines in HAL1 are used by : HAL PKA clear flag, and HAL PKA get flag.

HAL1

HAL2



#define PKA_FLAG_ADDRERR


#define PKA_FLAG_OPERR


#define PKA_FLAG_PROCEND

#define PKA_FLAG_RAMERR

All PKA flag definitions and macros are removed from HAL2.

  • Removed: Use LL_PKA_ClearFlag_ADDERR / LL_PKA_IsActiveFlag_ADDRERR instead.

  • Removed: Use LL_PKA_ClearFlag_OPERR / LL_PKA_IsActiveFlag_OPERR instead.

  • Removed: Use LL_PKA_ClearFlag_PROCEND / LL_PKA_IsActiveFlag_PROCEND instead.

  • Removed: Use LL_PKA_ClearFlag_RAMERR / LL_PKA_IsActiveFlag_RAMERR instead.


HAL PKA IT constants

The listed defines in HAL1 are used by: HAL PKA enable interrupt, HAL PKA disable interrupt, and HAL PKA get it source.

HAL1

HAL2


#define PKA_IT_ADDRERR

#define PKA_IT_OPERR

#define PKA_IT_PROCEND

#define PKA_IT_RAMERR

All PKA interrupt definitions and macros are removed from HAL2.

  • Removed: Use LL_PKA_EnableIT_ADDRERR / LL_PKA_DisableIT_ADDERR / LL_PKA_IsEnabledIT_ADDRERR instead.

  • Removed: Use LL_PKA_EnableIT_OPERR / LL_PKA_DisableIT_OPERR / LL_PKA_IsEnabledIT_OPERR instead.

  • Removed: Use LL_PKA_EnableIT_PROCEND / LL_PKA_DisableIT_PROCEND / LL_PKA_IsEnabledIT_PROCEND instead.

  • Removed: Use LL_PKA_EnableIT_RAMERR / LL_PKA_DisableIT_RAMERR / LL_PKA_IsEnabledIT_RAMERR instead.


HAL PKA mode options constants

HAL1

HAL2

#define PKA_MODE_MONTGOMERY_PARAM
#define PKA_MODE_MODULAR_EXP
#define PKA_MODE_MODULAR_EXP_FAST_MODE
#define PKA_MODE_ECC_MUL
#define PKA_MODE_ECDSA_SIGNATURE
#define PKA_MODE_ECC_MUL_FAST_MODE
#define PKA_MODE_ECDSA_VERIFICATION
#define PKA_MODE_POINT_CHECK
#define PKA_MODE_RSA_CRT_EXP
#define PKA_MODE_MODULAR_INV
#define PKA_MODE_ARITHMETIC_ADD
#define PKA_MODE_ARITHMETIC_MUL
#define PKA_MODE_ARITHMETIC_SUB
#define PKA_MODE_COMPARISON
#define PKA_MODE_MODULAR_RED
#define PKA_MODE_MODULAR_ADD
#define PKA_MODE_MODULAR_SUB
#define PKA_MODE_MONTGOMERY_MUL
#define PKA_MODE_ECC_PROJECTIVE_AFF
#define PKA_MODE_DOUBLE_BASE_LADDER
#define PKA_MODE_ECC_COMPLETE_ADD
#define PKA_MODE_MODULAR_EXP_PROTECT

Removed ; used internally in HAL1 and had no impact on user-level operations.


HAL PKA operation status constants

HAL1

HAL2

#define PKA_NO_ERROR
#define PKA_FAILED_COMPUTATION
#define PKA_RPART_SIGNATURE_NULL
#define PKA_SPART_SIGNATURE_NULL

Used internally and do not affect user-level operations.